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PREFACE 



This publication is intended for system 
programmers and IBM Field Engineering 
personnel. The reader should be famil- 
iar with the general machine functions 
of 370-XA> as described in the IBM 
370--XA Pr i nci pies of Qperat i on » 
SA22-7085, and with the MVS/SP Version 2 
Licensed Program^ referred to in this 
publication as the MVS/XA control 
program. The standard names for MVS/XA 
control blocks are used throughout the 
publication. The formats of these 
control blocks are described in the 
MVS/XA Debuqqj nq Handbook , Volumes 1 
through 5, LC28-1164 through LC28-1168, 
respect i vely. 
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ASSISTS FOR MVS/XA 



This publication describes six 

instructions that depend on control 
blocks whose formats and relationships 
normally are established only by the 
MVS/XA control program. These 

instructions improve performance in 
frequently used parts-^f the MVS/XA 
control program on machines which 
provide the 370-XA architectural mode 
and these instructions. Four of the 
instructions assist the handling of 
control-program locks. A locking proto- 
col is used by the MVS/XA control 
program to achieve serial use of 
control-program resources! when multipro- 
gramming and multiprocessing activities 
may cause temporary^ multiple demands 
for the same resource. One instruction 
assists the execution of the SUPERVISOR 
CALL instruction, which is frequently 
used to request control-program 
services. The remaining instruction 
helps in establishing parameters that 
are used by the MVS/XA control program 
following detection of certain failure 
and error conditions. The six 
instructions areJ 

ADD FRR 

OBTAIN CMS LOCK 
OBTAIN LOCAL LOCK 
RELEASE CMS LOCK 
RELEASE LOCAL LOCK 
SVC ASSIST 

All of the instructions are privileged 
i nstruct i ons . 

ADD FRR uses the RRE instruction format: 



Op Code 


//////// 


R, 


R2 



0 16 24 28 31 



The other instructions use the SSE 
format. The SSE instruction format is: 







r— / 1 




Op Code 


Bt 


D, 


B2 1 






/ 1 





0 16 20 32 36 47 

In addition to the operands explicitly 
designated by the instructions, implicit 
operands at fixed storage locations are 
also used. Sometimes operands fetched 
from storage are used in turn for 
addressing still other operands. Unless 
otherwise stated^ all operand addresses 
are logical. Either 24 or 31 bits are 
used for addressing, depending on the 
value of the A-mode bit in the current 
PSW. The leftmost eight bits or the 
leftmost bit, depending on the A-mode 
bit in the current PSW, are ignored in a 
word which is a source of an operand 
address or a branch address. Storage 



protection applies to all storage opai — 
and accesses in the usual way. A 
specification exception is recognized 
for any operand that does not meet a 
specified alignment requirement, and 
instruction execution is suppressed. 

Not all possible operands are accessed 
for every execution of an instruction. 
In some cases the state of control bits 
or the results of comparisons of oper- 
ands determine which operands are subse- 
quently accessed. Exceptions may or may 
not be recognized for operands not need- 
ed for completion of a particular 
execution of an instruction, except 
where the definition of a particular 
instruction notes restrictions. 

Program-event recording applies in the 
usual fashion to these instructions, 
except that branch events are not recog- 
nized when these instructions cause 
branchi ng. 

The two instructions which obtain locks 
fetch and test a word for zeros, and, if 
the fetched word is zero, cause a speci- 
fied value to be stored back at the same 
location by means of an interlocked 
update. The two instructions which 
release locks may perform a conditional 
interlocked update of a doubleword 
location. For these instructions, if 
the second word of a doubleword location 
contains all zeros, the entire double- 
word is set to zeros by means of an 
interlocked update. When the SVC ASSIST 
instruction is used to assist a type-1 
SVC, a conditional interlocked update of 
a doubleword location is performed which 
is similar to that performed by the 
COMPARE DOUBLE AND SWAP instruction. 

The four lock-handling instructions may, 
under certain conditions, access the 
lock-interface-table prefix, consisting 
of the four words at negative offsets 
from the lock-interface table. The 
lock-interface table is located by using 
an address contained in the word in main 
storage folloMing the second operand. 



SIMPLIFIED EXECUTION PATHS 



Simplified execution paths are defined 
for the following instructions. When a 
simplified path is used, specific 
actions defined for the corresponding 
instruction are performed uncondi- 
tionally; that is, specific actions are 
taken without the prescribed tests being 
made to determine that those actions 
should be selected. 



1 



• OBTAIN CMS LOCK . Execution 
proceeds as if a CMS lock Mere 
already held. 

• OBTAIN LOCAL LOCK . Execution 
proceeds as if the local lock Mere 
already held. 

• RELEASE CMS LOCK. Execution 
proceeds as if the currently 
dispatched unit of Mork held no CMS 
lock. 

RELEASE LOCAL LOCK . Execution 
proceeds as if the local lock Mere 
already released. 

• SVC ASSIST . Instruction execution 
is completed with normal instruc- 
tion sequencing and without the 
performance of other actions. 

Use of the simplified execution paths is 
not apparent to application programs 



using program products. In certain 
models> simplified execution paths are 
used Mhen the available control-storage 
space is limited. The ADD FRR instruc- 
tion is optional and may or may not be 
provided as part of the assists. 



INSTRUCTIONS 



The instructions described in this 
section are listed in the figure 
"Instruction Summary*" as are their 
operation codes and the program- 
interruption conditions that can be 
recognized Mhen they are executed. 

In the format shown in the instruction 
description, the operation code is given 
in hex, which is signified by enclosing 
its value in single quotation marks 
CXXXX' ). 



Name 


Character! sti cs 


Code 


ADD FRR 


RRE 


M 


A 


SP 


R OP 


ST 


B242 


OBTAIN CMS LOCK 


SSE 


M 


A 


SP 


R 


ST 


E506 


OBTAIN LOCAL LOCK 


SSE 


M 


A 


SP 


R 


ST 


E504 


RELEASE CMS LOCK 


SSE 


M 


A 


SP 


R 


ST 


E507 


RELEASE LOCAL LOCK 


SSE 


M 


A 


SP 


R 


ST 


E505 


SVC ASSIST 


SSE 


M 


A 


SP 


R 


ST 


E503 



Explanati on : 

A Access exceptions 

M Privileged-operation exception 

OP Operation exception 

R PER general-register-alteration event 

RRE RRE instruction format 

SP Specification exception 

SSE SSE instruction format 

ST PER storage-alteration event 



Instruction Summary 
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ADD FRR 



OBTAIN CMS LOCK 



[RRE] 





//////// 


R, 





16 



24 



28 31 



Goneral Form 







1 / 1 






•E506* 


B, 


D, 


B, 








1 / 1 







16 



20 



32 



36 



3 



47 



A new entry is added to the top of the 
current f unct i onal - recovery-rout i ne 

(FRR) stack. The entry is initialized 
with values provided in general regis- 
ters, with the PSW A-mode bit (bit 32), 
and with the PSW S bit (bit 16). 
Optionally, the contents of control 
registers 3 and 4 are saved in an entry 
in a separate table - 

The general register designated by the 
R2 field provides the logical address of 
the FRR entry point. 

Before instruction execution, the genei — 
al register designated by the Ri field 
provides three bytes that are stored in 
the new FRR entry and whose value deter- 
mines if control registers 3 and 4 are 
to be stored as well. Ulhen instruction 
execution is completed, the register 
designated by Ri contains the logical 
address of the six-word work area within 
the new, current FRR-stack entry. 

Logical location 380 hex contains the 
logical address of the stack-table head- 
er. The stack-table header contains 
(1) a logical address which is 32 less 
than the address of the first dynamic 
entry in the stack table, (2) the 
logical address of the last entry in the 
stack table, and (3) the logical address 
of the current stack-table entry. 

At an offset from the beginning of the 
stack-table header is found a table of 
stack-entry-extension entries. 
Optionally, the contents of control 
registers 3 and 4 are saved in an exten- 
sion entry. One extension entry 
corresponds to each entry in the stack 
table. The offset to the table of 
extension entries, and the encoded 
length of an extension entry, are found 
in the word at logical location BA8 hex. 

Condi t i on Code^ The code remains 
unchanged. 

Program Except i ons? 

Access (storage operands) 
Operation (when the instruction is 

not installed) 
Privileged operation 
Speci f i cat i on 



Forms Used i n the Control Program 







1 / 1 






•E506' 




»224» 




»2 






1 / 1 







16 



20 



32 36 



»2F8»J 
47 



or 







1 — ' 1 






•E506» 




»ooo» 


»o» 


»2 






1 — / 1 







'2F 8' I 



16 20 



32 36 



47 



If the word fetched from the second- 
operand location shows that the execut- 
ing CPU holds the local lock and does 
not hold a CMS lock, and if the CMS lock 
addressed by general register 11 is not 
held, then the lock is replaced, by 
using an interlocked update, with the 
first-operand word. Also, an indicator 
is set to show that a CMS lock is held, 
and zeros are placed in general register 
13. 

Otherwise, the updated instruction 
address is placed in general register 
12, with a zero placed in bit position 
0; the contents of the word at LIT minus 
8 are placed in general register 13, and 
bits are selected from the word which 
replace the instruction-address portion 
of the PSW, leaving the A-mode bit 
unchanged. 



Serialization occurs 
fetched and, if the 
again after the lock 



before the lock is 
lock is obtained, 
is updated. 



Condi t i on Code: The 
unchanged . 

Program Except i ons: 

Access 

Privileged operation 
Speci fi cat i on 



OBTAIN LOCAL LOCK 



code 



remai ns 



General Form 







1 ^ 1 






»E504' 


B, 


D, 


B2 








1 / 1 







16 20 



32 36 



47 
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Form Used i n the Control Program 







1 — / 1 








• o» 






»2 






1 / 1 







16 20 



32 36 



47 



If the local lock in the ASCB addressed 
by the first-operand word is not held» 
the lock is replaced* by using an inter- 
locked update* Mith the value from the 
Mord at the second-operand location 
minus 4; the local-lock bit of the word 
fetched from the second-operand location 
is set to one; and zeros are placed in 
general register 13. 

Otherwise* the updated instruction 
address is placed in general register 
12* with a zero placed in bit position 
0; the contents of the word at LIT minus 
16 are placed in general register 13* 
and bits are selected from the word 
which replace the instruction-address 
portion of the PSU* leaving the A-mode 
bit unchansted. 

Serialization occurs before the local 
lock is fetched and* if the lock is 
obtained* again after the lock is 
updated. 



Condi t i on Code: The 
unchanged. 

Program Excepti ons? 

Access 

Privileged operation 
Speci f i cati on 



code remains 



after the CMS lockword is zero* then the 
doubleword containing the lockword is 
set to zero by using an interlocked 
update. Also* the word fetched from the 
second-operand location is set to show 
that no CMS lock is held* and zeros are 
placed in general register 13. 

Otherwise* the updated instruction 
address is placed in general register 
12* with a zero placed in bit position 
0* the contents of the word at LIT minus 
4 are placed in general register 13* and 
bits are selected from the word which 
replace the instruction-address portion 
of the PSU* leaving the A-mode bit 
unchanged . 



Condi t i on Code? The 
unchanged. 

Program Except i on st 

Access 

Privileged operation 
Speci f i cati on 



RELEASE LOCAL LOCK 



code remains 



General Form 







1 ^ 1 






»E505» 


Bt 


D. 


Ba 








' / 1 







16 20 



32 36 



47 



Form Used i n the Control Program 



RELEASE CHS LOCK 



General Form 







1 ^ 1 






»E507' 


B, 




B, 








1 / 1 





16 



20 



32 36 



47 



Forms Used i n the Control Program 







1 — / 1 






'E507' 




•224» 


»0» 


'2 






1 y 1 







*2F 8' I 



16 



20 



32 36 



47 



or 







1 ^ 1 






•E507' 


»c» 


»ooo» 




»2 






' — / ' 







/ I 

*2F 8' I 



16 20 



32 36 



47 



If (1) the contents of the CMS lockword 
addressed by general register 11 equal 
the contents of the first-operand word* 
(2) the currently dispatched unit of 
work holds a CMS lock* and (3) the word 







1 ^ 1 






»E505» 




'224' 


•0' 


•2 






1 / 1 







•2F8» I 
/ I 



16 



20 



32 



36 
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If the word fetched from the second- 
operand location shows that the execut- 
ing CPU holds the local lock and does 
not hold a CMS lock* and if the word 
after the local lock word in the ASCB 
addressed by the first-operand word is 
zero* then the doubleword containing the 
lock is set to zero by using inter 
locked update. Also* the local-lock bit 
of the hi ghest-lock-held-i ndi cator word 
is set to zero* and zeros are placed in 
general register 13. 

Otherwise* the updated instruction 
address is placed in general register 
12* with a zero placed in bit position 
0; the contents of the word at LIT minus 
12 are placed in general register 13^ 
and bits are selected from the word 
which replace the instruction-address 
portion of the PSU* leaving the A-mode 
bit unchanged. 



Condi ti on Code: 
unchanged. 



The 



code remains 
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Program Except i ons t 
Access 

Privileged operation 
Speci f i cat i on 



SVC ASSIST 



General Form 







1 ^ 1 






•E503' 


B, 


D, 










1 / 1 







16 



20 



32 36 



47 



Form Used i n the Control Program 



E503 



-/- 



— / — 



'21 0' I 



16 20 



32 36 



47 



The first and second operands are Mords 
containing the addresses of the current 
ASCB and TCB> respectively. 

Main-storage locations which contain 
status for the last SVC interruption are 
tested to determine if SVC-assi st action 
is to be taken. If SVC-assi st action is 
not taken/ instruction execution is 
completed with normal instruction 
sequencing. No assist action is taken 
unless the CPU was enabled prior to the 
last SVC i nterrupt i on» and a task is 
currently dispatched which holds no 
locks and for which SVC screening is not 
activated. In addition^ no assist 
action is taken unless (1) both the 
primary space and the secondary space 
match the dispatched space^ and 
(2) primary-space mode is specified in 
the supervisoi — call old PSUI. 

A type-1 SVC request is assisted only if 
the request is for an assi stable type-1 
function, if the only lock needed for 
the requested SVC function is the local 
lock, and if an attempt to obtain the 
local lock is successful. 

A type-2, -3, or -4 SVC request is 
assisted only if the request is for an 
assi stable function of type 2, 3, or 4, 
and if an attempt to dequeue an SVRB 
from the SVRB pool of the current 
address space is successful. 



A type-6 SVC request is assisted only if 
the request is for an assi stable type-6 
function for which no locks are needed. 

Assist action consists in copying the 
information stored at the last SVC 
interruption into the current request 
block, saving all 16 general registers, 
loading the general registers as shown 
below, and then loading the instruction 
address portion of the PSW from general 
register 9. 



GR No, 
3 
4 
5 



11 



12 



Contents Loaded 
on Assi st Act i on 

Address of CVT 

Second operand 

Address of the current RB for 
type 1 or type 6; address of 
the acquired SVRB for type 2, 
3 , or 4 

SVC entry-point address 
First operand 

Address of the RB for the 
program which was being 
executed at SVC interruption 

Entry address from that MPL 
field which is appropriate to 
the SVC type, that is, the 
address of the routine that 
receives control on completion 
of the assist 

Address of the MBCB part of 
the SVRB acquired; for type 2, 
3, or 4 only 

Address of requested SVC-table 
entry 



14 Exit address from that MPL 

field which is appropriate to 
the SVC type 



Condi ti on Code: The 
unchanged. 

Program Excepti ons: 

Access 

Privileged operation 
Speci f i cati on 



code remains 
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